home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / ds_212.arc / DS_READ.ME < prev    next >
Text File  |  1986-05-27  |  12KB  |  216 lines
  1.                         DIRECTORY SCANNER PROGRAM
  2.                                Ver 2.12
  3.  
  4.  ///  Users of Ver 2.10 (and earlier) updating to Ver 2.12 MUST (repeat     \\\
  5. ***   MUST) use the new  version  of DS_DRIVE.SYS contained herein.          ***
  6.  \\\  Ver 2.10 will not work correctly with older versions of DS_DRIVE.SYS. ///
  7.  
  8.     Presents a full screen display of the directory structure of a given
  9. disk drive.  The display looks like the following:
  10.  
  11. █████ Drive  C ███████████████████████████████ C:\DIR2 ████████████████████████
  12. █ C:\                █  backup  .exe    ║ finder  .com     ║ guts    .zzz     █
  13. █  ╟─ dir1           █  create  .com    ║ finder  .exe     ║ help    .def     █
  14. █  ╟─ dir2           █  dump    .asm    ║ finder  .obj     ║ killer  .com     █
  15. █  ║   ╟─ sub1       █  dump    .exe    ║ guts    .asm     ║ print   .com     █
  16. █  ║   ╙─ sub2       █  dump    .obj    ║»guts    .com«    ║ qsort   .exe     █
  17. █  ╙─ dir3           █  eater   .bas    ║ guts    .exe     ║ vdisk   .sys     █
  18. █                    █  eats            ║ guts    .obj     ║ zoo     .bas     █
  19. █                    █  eatz    .bat    ║                  ║                  █
  20. █                    █                  ║                  ║                  █
  21. █                    █                  ║                  ║                  █
  22. █                    █                  ║                  ║                  █
  23. █                    █                  ║                  ║                  █
  24. █                    █                  ║                  ║                  █
  25. █                    █                  ║                  ║                  █
  26. █                    █                  ║                  ║                  █
  27. █                    █                  ║                  ║                  █
  28. █                    █                  ║                  ║                  █
  29. █                    █                  ║                  ║                  █
  30. █                    █                  ║                  ║                  █
  31. █                    █                  ║                  ║                  █
  32. ███████████████████████████████████████████████████████████████████████████████
  33. Total: 10,456,123 │ Disk  80% Full │ Files: 22   Used: 137,354        Tagged: 0
  34. Used:   8 000,000 │ Free Core 146K │ ────name────  ──size── ──date─── time─ atr
  35. Free:   2,456,123 │ Help=?  Lev: 1 │ guts    .com    17,123 10 Aug 85 18:30 r
  36. -------------------------------------------------------------------------------
  37. This program consists of the following files:
  38.  
  39.    DS_READ.ME   - This read.me file
  40.  
  41.    DS_DRIVE.SYS - File loaded as a device driver that reserves 10K of memory 
  42.                     to store hard  disk  directory  structure  information.  
  43.                     This  memory  area is used so that upon reactivation of 
  44.                     "DS.EXE",  repeat scanning of the disk is not needed to 
  45.                     determine  the  disk  directory  structure.  This  file 
  46.                     requires the following entry in your "CONFIG.SYS" file: 
  47.  
  48.                           DEVICE=DS_DRIVE.SYS  D:C
  49.                                                ^^^--- Drive specifier
  50.  
  51.                              where  D:C    indicates only drive C  will  be 
  52.                                            maintained by the driver.
  53.                                or   D:CD   indicates drives C & D  will  be
  54.                                            maintained by the driver.
  55.  
  56.                                     Currently only a max of 2 drives may be
  57.                                           specified.     If    the    drive 
  58.                                           specifier is left off, the device 
  59.                                           driver  will  default to saving 2 
  60.                                           drives and  both  must  be  fixed 
  61.                                           disks.  If  you  have  only  1 HD 
  62.                                           drive  to   save,   it's   highly 
  63.                                           recommended that you specify that 
  64.                                           1 drive so that the device driver 
  65.                                           will allocate all of its reserved 
  66.                                           memory  area  for that one drive.  
  67.                                           It is recommended that you do not 
  68.                                           specify floppy disk drives or RAM 
  69.                                           drives here as they  take  little 
  70.                                           time  to  rescan  the  full drive 
  71.                                           directory structure.  
  72.  
  73.                     so that upon booting your system, the file is loaded as 
  74.                     a device driver.  Upon successful booting  and  loading 
  75.                     of this file you should see the following message: 
  76.  
  77.                           "DSCANNER Data Area Reserved"   
  78.  
  79.                     This file is  mandatory  for  the  program  to  operate 
  80.                     correctly.  Without  this file the DS program must seek 
  81.                     out the entire hard disk directory structure each  time 
  82.                     the   program   is   activated.   This  disk  directory 
  83.                     structure scan  can  take  upwards  of  10  seconds  to 
  84.                     accomplish  on a 10M hard disk.  Even longer for larger 
  85.                     and fuller hard disks. With this file installed at boot 
  86.                     time the DS.EXE program can maintain directory data  on
  87.                     up to 2 drives.  
  88.  
  89.    DS.EXE    -   The directory scanner program.  Can be executed by  typing
  90.                     the following: 
  91.  
  92.                          "ds" - Start program on the default drive.  If the 
  93.                                   DS_DRIVE.SYS  memory area has been loaded 
  94.                                   and    contains    directory    structure 
  95.                                   information  then  rescanning of the disk 
  96.                                   for the directory structure info  is  not 
  97.                                   necessary.  
  98.  
  99.                          "ds c" - Start program with "c" drive as the first 
  100.                                   displayed  drive.  This  format  is  also 
  101.                                   used  if  it  becomes necessary to rescan 
  102.                                   the disk directory  structure  and  avoid 
  103.                                   using    possibly    outdated   directory 
  104.                                   structure information  contained  in  the 
  105.                                   DS_DRIVE.SYS driver memory area. There is 
  106.                                   an option within the DS program (Cntrl-D) 
  107.                                   to   rescan  the  drive  and  update  the 
  108.                                   directory structure information  so  that 
  109.                                   exiting and re-entering DS with "ds c" is 
  110.                                   not necessary.  
  111.  
  112.  
  113.    DS_BKUP.EXE   - The backup program which is activated from within the DS 
  114.                     program  by  selecting the "b" option.  This program is 
  115.                     not  a  self sufficient program.  It cannot be executed 
  116.                     on its own and work  properly.  It  expects  to  obtain 
  117.                     directory  structure  information from the DS_DRIVE.SYS 
  118.                     memory area.  The DS_BKUP.EXE program must reside in  a 
  119.                     directory in your PATH.  
  120.  
  121.  
  122.    DS_.DOC       - An abbreviated user document.
  123.  
  124.  
  125.    DS_MOUSE.MSC  - Source  file for a  Mouse  Systems optical mouse  device
  126.                    driver.
  127.  
  128.  
  129.    Current Program Limitations:
  130.  
  131.        MS/PC DOS 2.0+
  132.  
  133.        Maximum number of fixed/hard disk drives supported: 2
  134.            (plus any number of floppy/RAM drives)
  135.  
  136.        Maximum number of directories per drive: 100
  137.  
  138.        Maximum number of files per directory: 250
  139.  
  140.        Maximum length of full pathname for any directory: 38 characters
  141.  
  142.        These limitations were chosen for no particular reason.  The program 
  143.        can be recompiled extending these limitations, but with a consequent 
  144.        increase in the size of the program.  The program currently takes up 
  145.        approximately 50K during execution. This does not include the backup 
  146.        option (which during  execution  takes  up  additional  core  -  but 
  147.        releases it upon termination of the option), nor does it include the 
  148.        ds_drive.sys device driver which permanently reserves an area in low 
  149.        memory.  
  150.  
  151.    Revision History:
  152.  
  153.        Ver 2.00  -  Initial public release
  154.  
  155.        Ver 2.10  -  Added CTRL-L option to show program limits.  Also added
  156.                     limit checks  to detect excessive directories/files and
  157.                     inform  user  of  problem.  Offending directories/files
  158.                     are ignored and program continues execution.
  159.  
  160.                  -  Added  ALT-F  option to show free space on drives other
  161.                     than the current drive.
  162.  
  163.                  -  Increased stack size in an attempt to eliminate sporadic
  164.                     stack overflow errors in file sort routine.
  165.  
  166.                  -  Bug  Fix.  Copy/Move  option with destination directory
  167.                     of  only  2  or  3 characters (ie: \c  or  \ds) did not
  168.                     work correctly.
  169.  
  170.        Ver 2.11  (27 May 86)
  171.                 
  172.                  -  Temporary  patch  to  file sort routine stack overflow
  173.                     problem.  
  174.  
  175.                  -  Added ALT-X option to allow execution of indicated file
  176.                     with I/O redirection possible.  Original "X" option did
  177.                     not allow for redirection.
  178.  
  179.                  -  Modified DS_DRIVE.SYS device driver to  allow  the user
  180.                     to specify the drives the driver should save. This will 
  181.                     allow users with  other  than  fixed  disks  (Bernoulli 
  182.                     boxes for example) to specify their desires.  See above 
  183.                     explanation on DS_DRIVE.SYS for proper specification of 
  184.                     desired drives.  
  185.  
  186.        Ver 2.12  (29 May 86)
  187.  
  188.                  -  Bug Fix to backup option introduced by Ver 2.11
  189.                     where backup option listed 1 file in each directory
  190.                     twice and left off 1 file that was really there.
  191.  
  192.    Author:  LCDR Nat Martino
  193.  
  194.             currently:
  195.                    Computer Science Department
  196.                    U. S. Naval Academy
  197.                    Annapolis, MD  21402-5002
  198.                    (301) 267-2797
  199.  
  200.             after 1 June 1986:
  201.                    Pacific Missile Test Center (Code 4002)
  202.                    Point Mugu, CA  93042-5000
  203.                    (805) 989-7535
  204.  
  205.             As I am not requesting  any  financial  contributions  for 
  206.             using this program,  my only gratification is that someone 
  207.             finds this program to be of use to them.  I would  request 
  208.             of  those  that  do  find  this  program  to be of use the 
  209.             following: 
  210.  
  211.                1) Give me a call (not collect) or drop me a line so  I 
  212.             know that someone is actually using the program.  
  213.  
  214.                2)  Write  a  program  of  your own and place it in the 
  215.             public domain so I can use it.  
  216.